home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / runwen15.zip / RUNWEN.DOC < prev    next >
Text File  |  1992-08-16  |  7KB  |  159 lines
  1.      **********************************************************************
  2.      *                                                                    *
  3.      *                       RunWen Users Manual                          *
  4.      *                                                                    *
  5.      *              RunWen - A Boot-up Program Scheduler                  *
  6.      *                                                                    *
  7.      *               Copyright (c) 1992 Richard Hiester                   *
  8.      *                       All Rights Reserved                          *
  9.      *                                                                    *
  10.      **********************************************************************
  11.  
  12.      INTRODUCTION
  13.      ============
  14.  
  15.      RunWen is a DOS Program Scheduler which is normally started from your 
  16.      AUTOEXEC.BAT file.  This means that the programs you specify will be
  17.      started by RunWen when you boot-up your computer.  RunWen can age
  18.      the specified programs to run everytime you boot your computer, once 
  19.      a day, or once every N days.  Options are available to specify how
  20.      you want RunWen to run (in prompt or noprompt mode), to list the 
  21.      RunWen source file (RUNWEN.FIL), to display the RunWen Version number,
  22.      and to display a two-page help screen.
  23.  
  24.      INSTALLATION
  25.      ============
  26.  
  27.      The following files are part of this release of RunWen:
  28.  
  29.           RUNWEN.EXE   - The RunWen executable.
  30.           RUNWEN.FIL   - The RunWen source file.
  31.           RUNWEN.DOC   - This documentation file.
  32.           ORDERFRM.DOC - The order form used to register RunWen.
  33.  
  34.      The installation of RunWen is easy:
  35.  
  36.      1)  Copy the above files into your desired directory.
  37.  
  38.      2)  Edit the RUNWEN.FIL source file to specify which DOS programs 
  39.          you want aged.
  40.  
  41.      3)  Edit your AUTOEXEC.BAT file adding the following lines:
  42.  
  43.               set RUNWEN=DRIVE:\DIRECTORY_TO_RUNWEN.FIL
  44.  
  45.               [DRIVE:PATH]RUNWEN -BOOT [-NOPROMPT]
  46.  
  47.      4)  Reboot your computer to start using RunWen.
  48.  
  49.      CONFIGURATION
  50.      =============
  51.  
  52.      The only configuration necessary for using RunWen is to add your
  53.      desired programs to the RUNWEN.FIL source file.  The RUNWEN.FIL
  54.      file contains one line for each program you want aged.  For you
  55.      UNIX types, the RUNWEN.FIL format is simular to the crontab.  The
  56.      RUNWEN.FIL format is as follows:
  57.  
  58.      YYYYMMDD DYS DOS_COMMAND_LINE
  59.  
  60.                                                                    Page 2
  61.  
  62.      where YYYYMMDD is the four-digit year, two-digit month, and two
  63.      digit day that you want RunWen to start aging the program from,
  64.      DYS is the number of days you want between executions of the program,
  65.      and DOS_COMMAND_LINE is the DOS command line you would enter to start
  66.      the program.  For instance, one of the programs I use RunWen for
  67.      is to run the Norton AntiVirus program.  I have the following entry in
  68.      my RUNWEN.FIL to run the Norton AntiVirus (full scan, all disks)
  69.      every seven days:
  70.  
  71.      19920801 7 C:\NDW\NAV.EXE /A
  72.  
  73.      By placing the above line in the RUNWEN.FIL file, Norton AntiVirus 
  74.      will be run the first time you boot your computer on (or after) 
  75.      August 8, 1992.  When the program is run, the RUNWEN.FIL is updated
  76.      to the NEW last date the program was run.  That is, if the AntiVirus
  77.      program is run on August 8, 1992, the the new entry in the RUNWEN.FIL
  78.      file will be:
  79.  
  80.      19920808 7 C:\NDW\NAV.EXE /A
  81.  
  82.      and the AntiVirus program will not be run by RunWen again until 
  83.      August 15, 1992.  
  84.  
  85.      Please read the comment lines in the RUNWEN.FIL file for further
  86.      information about the RUNWEN.FIL file.
  87.  
  88.      OPTIONS
  89.      =======
  90.  
  91.      The command line for RunWen is as follows:
  92.  
  93.      C> RUNWEN [-BOOT [-NOPROMPT]] | [-LIST] | [-VER] | [-HELP]
  94.  
  95.      The options available on the RunWen command-line are as follows:
  96.  
  97.      -BOOT (abbreviated to -B) is used to tell RunWen to process the 
  98.           RUNWEN.FIL file.
  99.  
  100.      -NOPROMPT (abbreviated to -NOP) is used in conjunction with -BOOT
  101.           to tell RunWen not to prompt you whether you want to run 
  102.           the program which is due to be run by RunWen.
  103.  
  104.      -LIST (abbreviated to -L) is used to list the RUNWEN.FIL on the 
  105.           screen.  This option cannot be used in conjunction with the 
  106.           -BOOT [-NOPROMPT] options and is mutually exclusive of the
  107.           -VER and -HELP options.
  108.  
  109.      -VER (abberviated to -V) displays the version of RunWen you are
  110.           using on the screen.  This option cannot be used in conjunction
  111.           with the -BOOT [-NOPROMPT] options and is mutually exclusive of 
  112.           the -LIST and -HELP options.
  113.  
  114.      -HELP (abbreviated to -H or -?) displays a two-page help screen on
  115.           the use of RunWen.  This option cannot be used in conjunction 
  116.           with the -BOOT [-NOPROMPT] options and is mutually exclusive 
  117.           of the -VER and -LIST options.
  118.  
  119.                                                                    Page 3
  120.  
  121.      REGISTRATION
  122.     ============
  123.  
  124.      Registering your copy of RunWen is simple.  Just print out the 
  125.      ORDERFRM.DOC file, fill in the required information, and send it with
  126.      the requested payment amount.  Your registration will be processed per
  127.      your request and you will be placed on my mailing list for any future
  128.      upgrades.
  129.  
  130.      LICENSE
  131.      =======
  132.  
  133.      You are free to use, copy, and distribute the Shareware version of
  134.      RunWen so long as:
  135.  
  136.      1)  No fee is charged for its use.
  137.  
  138.      2)  If a fee is charged, it must be only to cover the cost of copying
  139.          or distribution.
  140.  
  141.      3)  It must be distributed in its original form with all of the 
  142.          originally released files intact.
  143.  
  144.      4)  It has not been modified in ANY way EXCEPT for compression.
  145.  
  146.      No part of the REGISTERED version of RunWen may be reproduced or
  147.      transmitted in any form or by any means, electronic or otherwise,
  148.      for any purpose other than the purchasers personal use, witout
  149.      the express written permission of the author.
  150.  
  151.  
  152.      WARRANTY
  153.      ========
  154.  
  155.      All warranties are disclaimed, including any damage to hardware and/or
  156.      software, from the use of this product.  In no event will I be held 
  157.      liable to you for any damage including lost profits, lost savings or
  158.      other incidental or consequential damages arising out or your use or
  159.      inability to use this program, or any other claim by any other party.